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A SUMMMARY FOR EXPERIENCED OPL usERS 


OPL has evolved from the Psion Organiser II through the MC and HC computers to the 
Series 3 and the Series 3a and then to the Series 3c and Siena and to the Series 5. This 
appendix gives a summary of the changes made from the Series 3a upwards. For more 
details of the following topics and keywords, look them up in the index or table of contents. 


Bear in mind that some OPL keywords return or allow different values according to 
screen size and keyboard layout. 
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Usinc OPL on THE SERIES 3A, SERIES 3c AND SIENA 
OPL on the Series 3c is similar to that on the Series 3a except for some differences with serial cables. 


Again the Siena is similar to these two, except for the size of its screen being around half that of the 
other two and also the fact that it does not have an SSD. 


Usinc OPL on THE Series 5 
The principal design requirements of OPL for the Series 5 were: 


e Compatibility with earlier versions of OPL. 


e Provision of a mechanism for language extensions to replace direct calls to the operating 
system. 


e Generally to take advantage of the abilities of EPOC32. 


The major difference between this and other versions of OPL is that 32-bit rather than 16-bit addressing 
is used. This means that the arguments and return values of quite a number of keywords have changed 
from being integers to long integers. 


Also graphics, menus, dialogs and database handling especially have been improved to take advantage 
of the abilities of EPOC32. 


Below the removed, new and changed features are listed. For this appendix to provide detailed 
information would represent a repetition of much of what has been described in the main chapters of 
this manual and you should refer to these for full details (especially useful is the ‘Alphabetic Listing’ 
which includes full details of all keywords for both the Series 5 and the Series 3c). 


The following keywords, available on earlier Psion machines (Series 3a, Series 3c and Siena), are 
no longer available on the Series 5: 


e RECSIZE and COMPRESS. COMPACT replaces COMPRESS. 
e gDRAWOBJECT. 
e gINFO. This is replaced by gINFO32. 


e STATUSWIN, STATWININFO, DIAMINIT and DIAMPOS. The Series 5 has no status 
windows. Toolbars are used instead See the ‘Toolbar Usage’ section in the ‘Friendlier 
Interaction’ chapter. 


e TYPE, PATH and EXT. These were provided on earlier machines for use by the System screen 
only. The Series 5 does not require this information. On the Series 5, applications do not have 
types, application-specific paths or filename extensions. An application and its associated 
documents are identified by a UID (unique identifier) instead. (A new command FLAGS has a 
similar function to TYPE.) See the ‘Advanced Topics’ chapter. 


© CMD$(4) and CMDS(5). 


e SETNAME. The new SETDOC, serves a similar purpose, and should be called before saving 
your main document. 


e Named Calculator memories and MO,...,M9. The Series 5 Calculator does not use OPL to 
evaluate expressions. 


e CACHE, CACHETIDY, CACHEHDR and CACHEREC. On the Series 5 procedures are 
automatically cached. 


e CREATESPRITE, APPENDSPRITE, CHANGESPRITE, DRAWSPRITE, POSSPRITE and 
CLOSESPRITE. Superior sprite-handling OPX functions are provided. See the ‘Sprite and 
Bitmap OPX’ section in the ‘Using OPXs on the Series 5’ chapter. 


e OS and CALL. The Series 5 provides extensibility using special OPL DLLs. See the ‘Using 
OPXs on the Series 5’ chapter. 


e USR and USR$. 
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e ODBINFO. This is implementation specific. 


e LOADLIB, LINKLIB, UNLOADLIB, FINDLIB, GETLIBH, NEWOBJ, NEWOBJH, SEND, 
ENTERSEND and ENTERSENDO. OPXs are now used for calling language extensions and 
creating object instances. See the ‘Using OPXs on the Series 5’ chapter. 


The following keywords have been added to OPL on the Series 5: 


e DECLARE EXTERNAL, EXTERNAL, INCLUDE and CONST allow the use of header files 
which include the definition of constants and procedure prototypes. 


e mCASC and mPOPUP provide new menu features. 
e dCHECKBOX and dEDITMULTI provide new features for dialogs. 
e DAYSTODATE allows easy conversion of “days since 1/1/1990” to a date. 
e gCOLOR, gCIRCLE, gELLIPSE and gsETPENWIDTH provide new graphics functionality. 
e gINFO32 replaces gINFO. 
e SETFLAGS and CLEARFLAGS allow for Series 3a/Series 3c/Siena compatibility 
e IOWAITSTAT32. 
Database commands: 
e DELETE allows deletion of a table. 
e INSERT, MODIFY, PUT and CANCEL allow the building up and editing of databases. 
e BOOKMARK, KILLMARK, GOTOMARK support the use of bookmarks in databases. 


e BEGINTRANS, COMMITTRANS, INTRANS and ROLLBACK support transactions in 
databases. 


e COMPACT replaces COMPRESS. 

OPL applications: 
e CAPTION and FLAGS allow definition of OPL applications; FLAGS is similar to TYPE. 
e SETDOC and GETDOCS$ allow files to be created as documents. 


e GETEVENT32, GETEVENTA32 and POINTERFILTER provide increased support for handling of 
events, including pointer (pen) events. 


Two other major additions have also been made to OPL. These are: 


e Support for Toolbars (to replace status windows). See the ‘Toolbar Usage’ section in the 
‘Friendlier Interaction’ chapter. 


e Support for language extensions in separate EPOC32 DLLs called OPXs. See the ‘Using OPXs on 
the Series 5’ chapter. 


The following keywords have undergone some changes, although many of these are compatible 
with earlier versions of OPL: 


e ADDR, ALLOC, ADJUSTALLOC, REALLOC, LENALLOC and FREEALLOC 
e APP and ICON 

e CMD§(3) 

e GETEVENT 

e BUSY 

e OFF 

e SCREENINFO 

e dBUTTONS, dCHOICE, dFILE, dINIT, dTEXT, dTIME and dXINPUT 
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e mCARD 
e CLOSE, COUNT, CREATE, OPEN, POS and POSITION 


e CURSOR, DEFAULTWIN, gBORDER, gBUTTON, gCLOCK, gCREATE, gCREATEBIT, 
gFONT, gGREY, gLINETO, gLINEBY, gLOADBIT, gSAVEBIT, gLOADFONT, 
gUNLOADFONT, gPEEKLINE and gXBORDER. 
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B OPERATORS AND LOGICAL EXPRESSIONS 
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OPERATORS 


These operators are available in OPL: 


Arithmetic operators 


+ add 

= subtract 

* multiply 

/ divide 

aK raise to a power 


- unary minus (in negative numbers for example, -10) 


% percent 


Comparison operators 


> greater than 

>= greater than or equal to 
< less than 

<= less than or equal to 

= equal to 

<> not equal to 


Logical and bitwise operators 
AND 


OR 


NOT 


The % operator 
The percentage operator can be used in expressions like this: 


Expression Meaning Result 
60+5% 60 plus 5% of 60 63 
60-5% 60 minus 5% of 60 57 
60*5% 5% of 60 3 
60/5% of what number is 60 5%? 1200 


It can also be used like this: 


105>5%what number, when increased by 5%, becomes 105? 100 
105<5%how much of 105 is a5% increase? 5 
Examples: 

To add 15% tax to 345: 

345+15% Result = 396.75 


To find out what the price was before tax: 
396.75>15% Result = 345 


To find out how much of a total price is tax: 
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396.75<15% Result = 51.75 


I Other operators 
On the Series 5, the System OPX provides two addtional operators: 
MOD&: (x&, y&) x& modulo y& (the remainder of x& divided by y&) 


XOR&: (x&, y&) exclusive OR of x& and y& 


Precedence 
Highest: le 

— (unary minus) 

NOT 

up 

+  — (subtraction) 

= > < <> >= <= 
Lowest: AND OR 


So 7+3*4 returns 19 (3 is first multiplied by 4, and 7 is added to the result) not 40 (4 times 10). 


When there is equal precedence 


In an expression where all operators have equal precedence, they are evaluated from left to right (with 
the exception of powers). For example, in a+b-c, a is added to b and then c 1s subtracted from the 
result. 


Powers are evaluated from right to left for example, in a&**b%**c%, b% will first be raised to the 
power of c% and then a% will be raised to the power of the result. 


Changing precedence with brackets 

The result of an expression such as a+b+c is the same whether you first add a to b, or b to c. But how 
is atb*c/d evaluated? You may want to use brackets to either: 

@ Make it obvious what the order of calculation is 

or 

e Change the order of calculation. 


By default, atb*c/d is evaluated in the order: b multiplied by c, then divided by d, then added to a. 
To perform the addition and the division before the multiplication, use brackets: (a+b) * (c/d). 
When in doubt, simply use brackets. 


Precedence of integer and floating-point values 
You are free to mix floating-point and integer values in expressions, but be aware how OPL handles the 
mix: 

e Ineach part of the calculation, OPL uses the simplest arithmetic possible. Two integers will use 
integer arithmetic, and this can give unexpected results: 7/2 gives the integer 3. Otherwise 
floating-point arithmetic is used (7 . 0 is a floating-point number, so 7.0/2 gives the 
floating-point number 3 . 5). 


e Finally, the evaluated result of the right-hand side of an expression is automatically converted to the 
same type as the variable to which it is assigned. 


For example, your procedure might include the expression aS=b%+c This is handled like this: b% is 
converted to floating-point and added to c. The resulting floating-point value is then automatically 
converted to an integer in order to be assigned to the integer variable a%. 
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Such conversions may produce odd results for example as=3.0* (7/2) makes a3=9, but 
a%=3.0* (7.0/2) makes at=10.OPL does not report this as an error, so it’s up to you to ensure 
that it doesn’t happen unless you want it to. 


Type conversions and rounding down 


There are three numeric types floating-point, integer and long integer. You can assign any of these 
types to any other. The value on the right-hand side will be automatically converted to the type of the 
variable on the left-hand side. For example: 


e Ifyou assign an integer value to a floating-point variable, there are no problems. 


e Ifyou assign a floating-point value to an integer variable, the value is converted to an integer, 
always rounded towards zero for example, if you declare LOCAL c% and then say c3=3.75, the 
value 3.75 is converted to the value 3. 


Rounding down towards zero can sometimes cause unusual results. For example, a3=2 . 9 would give 
a% the value 2, and at=-2.3 would give a% the value -2. 


When you run a module, if the left-hand side of an assignment has a narrower range than the right-hand 
side, you may get an error (for example, if you had x3=a& where aé& had the value 320000). 


To control how floating-point numbers are rounded when converted, use the INT function. 


LOGICAL EXPRESSIONS 


The comparison operators and logical operators are based on the idea that a certain situation can be 
evaluated as either true or false. For example, if as=6 and b%=8, as>b% would be ‘False’. 


These operators are useful for setting up alternative paths in your procedures. For example you could 
say: 


IF salary<expenses 


doBad: 








ELSE 








doGood: 





ENDIF 


You can also make use of the fact that the result of these logical expressions is represented by an 
integer: 


e ‘True’ is represented by the integer -1 


e ‘False’ is represented by the integer 0 (zero). 


operator example _ result returned return value 
< a<b True if a less than b -1 
False if a greater than or equal to b 0 
> a>b True if a greater than b -1 
False if a less than or equal to b 0 
<= a<=b True if a less than or equal to b -1 
False if a greater than b 0 
= a>=b True if a greater than or equal to b -1 
False if a less than b 0 
<> a<>b True if a not equal to b -1 
False if a equal to b 0 
7 a=b True if a equal to b =i 
False if a not equal to b 0 
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These integers can be assigned to a variable or displayed on the screen to tell you whether a particular 
condition is true or false, or used in an IF statement. 


For example, in a procedure you might arrive at two sub-totals, a and b. You want to find out which is 
the greater. So use the statement, PRINT a>b. If zero is displayed, a and b are equal or b is the larger 
number; if -1 is displayed, a>b is true a is the larger. 


LOGICAL AND BITWISE OPERATORS 


The operators AND, OR and NOT have different effects depending on whether they are used with 
floating-point numbers or integers: 


When used with floating-point numbers 
AND, OR and NOT are logical operators, and have the following effects: 


example result integer returned 
a AND b True if both a and b are non-zero -1 

False if either a or b are zero 0 
a OR b True if either a or b is non-zero -1 


False if both a and b are zero 
NOT a True if a is zero -1 


False if a is non-zero 


When used with integer or long integer values 
AND, OR and NOT are bitwise operators. 


The way OPL holds integer numbers internally is as a binary code - 16-bit for integers, 32-bit for long 
integers. Bitwise means that an operation is performed on individual bits. A bit is set if it has the value 
1, and clear if it has the value 0. Long integer values with AND, OR and NOT behave the same as 
integer values. 


AND 


Sets the result bit if both input bits are set, otherwise clears the result bit. 


For example, the statement PRINT 12 AND 10 displays 8. To understand this, write 12 and 10 in 
binary: 


12 000000000000110 0 
10 00000000000010i10 


AND acts on each pair of bits. Thus, working from left to right discounting the first 12 bits (since 0 
AND 0 gives 0): 


1 AND 1 = 1 
1 AND 0 — 0 
O AND 1 = 0 
O AND 0 = 0 


The result is therefore the binary number 1000, or 8. 


OR 


Sets the result bit if either input bit is set, otherwise clears the result bit. 


What result would the statement PRINT 12 OR 10 give? Again, write down the numbers in binary 
and apply the operator to each pair of digits: 


1 OR 17> 1 
1 OR 07> 1 
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0 (ORL 1 
0 OR 07> 0 


The result is the binary number 1110, or 14 in decimal. 


NOT 


Sets the result bit if the input bit is not set, otherwise clears the result bit. 


NOT works on only one number. It returns the ones complement, i.e. it replaces Os with 1s and 1s with 
Os. 


So since 7 is 0000000000000111, NOT 7 is 1111111111111000. This is the binary representation of -8. 


A quick way of calculating NOT for integers is to add | to the original number and reverse its sign. So 
NOT 23 is-24,NOT Ois-l and NOT -11s0. 
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C SERIAL/PARALLEL PORTS AND PRINTING 
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You can use LPRINT in an OPL program to send information (for printing or otherwise) to any of these 
devices: 


Ia parallel port, PAR:A 


A serial port, TTY:A 


A file on the Psion 


e I A file onan attached computer, e.g. on a PC or on an Apple Macintosh: 


—_— 


OPL does not provide access to the advanced page formatting and font control features of the 
Series 3c. 


—> 


OPL provides more advanced formatting features and printing control using Printer OPX. See the 
‘Using OPXs on the Series 5’ chapter for more details. 


You can also read information from the serial port. 


USING THE PARALLEL PORT ON THE SERIES 3C AND SIENA 





In your OPL program, set up the port with the statement LOPEN “PAR:A”. 
Provided the port is not already in use, the connection is now ready. LPRINT will send information 


down the parallel 3 Link lead for example, to an attached printer. 


Example 
PROC prints: 


OPI 


Gl 


N “clients”,A,a$ 





LOPEN “PAR:A” 





PRINT “Printing...” 
DO 


IF LEN (A.a$) 





LPRINT A.aS 


a 


NDIF 








NEXT 


UNTIL EOF 





LPRINT CHRS (12); :LCLOS! 





Gl 


PRINT “Finished” :GET 





ENDP 





USING THE SERIAL PORT 





In your OPL program, set up the port with the statement LOPEN “TTY:A”. 


Now LPRINT should send information down the serial link lead for example, to an attached printer. If 
it does not, the serial port settings are not correct. 


Serial port settings 





LOPEN “TTY:A” opens the serial port with the following default characteristics: 
9600 baud 


no parity 
8 data bits 
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1 stop bit 
RTS handshaking. 


e If your printer (or other device) does match these characteristics, the LOPEN statement sets the 
port up correctly, and subsequent LPRINT statements will print there successfully. 


e If your printer does not match these characteristics, you must use a procedure like the one listed 
below to change the characteristics of the serial port, before LPRINTs will print successfully to 
your printer. 


Printers very often use DSR (DSR/DTR) handshaking, and you may need to set the port to use this. 


Setting the serial port characteristics 
Calling the procedure 


The rsset: procedure listed below provides a convenient way to set up the serial port. 





Each time you use an LOPEN “TTY:” statement, follow it with a call to the rsset: procedure. 
Otherwise the LOPEN will use the default characteristics. 


Passing values to the procedure 

Pass the procedure the values for the five port characteristics, like this: 

rsset: (baud%,parity%,data%,stop%,hand%, &0) 

aN The final parameter, which should be &0 here, is only used when reading from the port. 


To find the value you need for each characteristic, use the tables below. You must give values to all 
five parameters, in the correct order. 


Baud = 50 75 110 134 150 300 600 1200 1800 2000 2400 3600 4800 7200 9600 19200 
value = 1 2 3 4 5 6 7 8 9 10 11 12 13 #14 #15 ~~ 16 
Parity = NONE EVEN ODD 

value = 0 1 2 

Data bits = 5, 6, 7 or 8 

Stop bits = 2 or 1 

Handshaking= ALL NONE XON RTS XON+RTS DSR XON+DSR_ RTS+DSR 
value = 11 4 7 0 3 12 15 8 


The rsset: procedure: 

PROC rsset: (baud%S,paritysS, datas, stops, hands, termé) 
LOCAL frame%,srchar%(6),dummy%, errs 
frames=data%s-5 


IF stop%s=2 :frames=frameS OR 16 :ENDIF 





IF parity :frameS=frame%S OR 32 :ENDIF 
srchar%(1)=baud% OR (baud%*256) 
srchar%(2)=frame% OR (parity%*256) 
srchar% (3)=(hand%S AND 255) OR $1100 
srchar% (4) =$13 


POKEL ADDR(srchar% (5) ),termé& 





errs=IOW(-1,7,srchar% (1) ,dummy%) 
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IF err% :RAISE err% : ENDIF 








ENDP 





Take care to type this program in exactly as it appears here. 


Example of calling the procedure 
PROC test: 


PRINT “Testing port settings” 


OPEN “TTY :A” 








LOADM “rsset” 
rsset: (8,0,8,1,0,&0) 


LPRINT “Port OK” :LPRINT 





PRINT “Finished” :GET 





CLOSE 








ENDP 





rsset: (8,0,8,1,0,&0) sets 1200 Baud, no parity, 8 data bits, 1 stop bit, and RTS/CTS 
handshaking. 


Advanced use 


The section of the rsset: procedure which actually sets the port is this: 
srchar%(1)=bauds OR (baud%*256) 

srchar% (2)=frameS OR (parity%*256) 
srchar%(3)=(hand%S AND 255) OR $1100 
srchar% (4) =$13 


POKEL ADDR(srchar%(5)),termé& 





errs=IOW(-1,7,srchar% (1) ,dummy%) 


errS :ENDIF 





IF err% :RAISI 





Gl 


The elements of the array srchar% contain the values specifying the port characteristics. If you want 
to write a shorter procedure, you could work out what these values need to be for a particular setup you 
want, assign these values to the elements of the array, and then use the IOW function (followed by the 
error check) exactly as above. 


Reading from the serial port 


If you need to read from the serial port, you must also pass a parameter specifying terminating mask for 
the read function. If terms is not supplied, the read operation terminates only after reading exactly the 
number of bytes requested. In practice, however, you may not know exactly how many bytes to expect 
and you would therefore request a large maximum number of bytes. If the sender sends less than this 
number of bytes altogether, the read will never complete. 


The extra parameter, termé , allows you to specify that one or more characters should be treated as 
terminating characters. The terminating character itself is read into your buffer too, allowing your 
program to act differently depending on its value. 


The 32 bits of termé each represent the corresponding ASCII character that should terminate the read. 
This allows any of the ASCII characters | to 31 to terminate the read. 


For example, to terminate the read when Control-Z (i.e. ASCII 26) is received, set bit 26 of terms. To 
terminate on Control-Z or <CR> or <LF> which allows text to be read a line at a time or until end of 
file set the bits 26, 10 and 13. In binary, this is: 
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0000 0100 0000 0000 0010 0100 0000 0000 


Converting to a long integer gives &04002400 and this is the value to be passed in termé for this 
case. 


aN Clearly termé cannot be used for Mee gt Aces which may include a terminating character by 
chance. You can sometimes get around this problem by using termé and having the sender 
transmit a leading non-binary header specifying the exact number of full-binary data following. 
You could then reset the serial characteristics not to use termé , read the binary data, and so forth. 
Example reading from serial port 


This example assumes that each line sent has maximum length 255 characters and is terminated by a 
<CR> and that Control-Z signals the end of all the data. 


PROC testread: 
LOCAL ret%,pbuf&,pbuf1&,buf$ (255) ,end%, len% 
PRINT “Test reading from serial port” 


OPEN “TTY :A” 











LOADM “rsset” REM receive at 2400 without h/shake 
rsset: (11,0,8,1,0, &04002000) REM Control-Z or CR 








pbuf &=ADDR (buf $) REM could be pbuf% on Series 3c 





DO REM read max 255 bytes, after leading count byte 
len%S=255 
pbuflé=pbufé+1 


ret%=I0W(-1,1, #pbuf1&, len) 





POKEB pbhufé, lens REM lens = length actually read 


a 


EM including terminator char 





end%=LOC (buf$,CHRS (26) ) 


ve) 


EM non-zero for Control-Z 


IF ret%<0O and ret%<>-43 















































BEEP 3,500 
PRINT 
PRINT “Serial read error: “;ERRS(ret%) 
ENDIF 
IF ret%<>-43 REM if received with terminator 
POKEB pbufé, len%s-1 REM remove terminator 
PRINT buf$ REM echo with CRLF 
ELSE 
PRINT bufS$; REM echo without CRLF 
ENDIF 





UNTIL end% 





PRINT “End of session” :PAUSE -30 :K 








El 
K 


ENDP 





aN Note that passing -1 as the first argument to I/O keywords means that the LOPEN handle is 
to be used. Also, OPL strings have a leading byte giving the length of the rest of the string, so the 
data is read beyond this byte. The byte is then poked to the length which was read. 
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PRINTING TO A FILE 


Printing to a file on the Psion 
In your OPL program, specify the destination file with an LOPEN statement like this: 


Tan 
I LOPEN “D:\PRINT\MEMO” 








X\ 


I LOPEN “B:\PRINT\MEMO. TXT” 








I Printing to a file on a PC or Apple Macintosh 
As if you were going to transfer a file: 
e Physically connect the Psion and the other computer. 
e Select the ‘Remote link’ option in the System screen and press Enter. 


e Run the server program (supplied with 3 Link if you are using a Series 3c or Siena, or with the 
Series 5 itself) on the other computer. 


In your OPL program, specify the destination file with an LOPEN statement. 


For example, to a PC: 





LOPEN “REM: :C:\BACKUP\PRINTOUT\MEMO.TXT” 

















Any subsequent LPRINT would go to the file MEMO. TXT in the directory \BACKUP\ PRINTOUT on 
the PC’s drive C:. 


With a Macintosh, you might use a file specification like this: 








LOPEN “REM: :HD40:MY BACKUP: PRINTED:MEMO5” 























An LPRINT would now go to the file MEMO5 in the PRINTED folder, itself in the MY BACKUP folder 
on the hard drive HD40. Note that colons are used to separate the various parts of the file specification. 
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D CHARACTER CODES 
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THE CHARACTER SET FOR THE SERIES 5 


The following are character code descriptions for the 8-bit character set used in the English version of 
EPOC32. The definition is intended to be synonymous with code page 1252 (also used by Microsoft 
for Windows systems). 


Those items in the ‘character’ column which are given in italics are descriptions. Particularly note that 
the code for backspace will be the code returned when you press Del, that for carriage return will be 
returned when you press Enter and that for escape when you press Esc. 


hex 
code 


00 
02 
04 
06 
08 
0A 


dec. 
code 


000 
002 
004 
006 
008 
010 
012 
014 
016 
018 
020 
022 
024 
026 
028 
030 
032 


dec. 
code 


034 
037 
040 
043 
046 
049 
052 
055 
058 
061 
064 


character 


null 

start of text 

end of transmission 
acknowledge 
backspace 

line feed 

form feed 

shift out 

data link escape 
device control two 
device control four 
synchronous idle 
cancel 

substitute 

file separator 


record separator 


(space) 
character hex 
code 
“ 23 
% 26 
( 9 
+ 2C 
2F 
1 32 
4 35 
7 38 
3B 
= 3E 
@ 41 


065 


hex dec. 
code code 
01 001 
03 003 
05 005 
07 007 
09 009 
0B 011 
0D 013 
OF 015 
11 017 
13 019 
15 021 
17 023 
19 025 
1B 027 
1D 029 
1F 031 
21 033 
character 

#t 

& 

) 

/ 

2 

5 

8 

> 

A 


character 


start of heading 

end of text 

enquiry 

bell 

horizontal tabulation 
vertical tabulation 
carriage return 

shift in 

device control one 
device control three 
negative acknowledge 
end of transmission block 
end of medium 

escape 

group separator 


unit separator 


hex dec 

code code 

24 036 $ 
27 039 ‘ 

2A 042 7 
2D 045 

30 048 0 
33 051 3 
36 054 6 
39 057 9 
3C 060 < 


3F 063 ? 
42 066 B 
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character 


43 
46 
49 
4C 
4F 
52 
55 
58 
5B 
5E 
61 
64 
67 
6A 
6D 
70 
73 
16 
79 
IC 
TF 
82 
85 
88 
8B 
8E 
91 
94 
97 
9A 
9D 
AO 
A3 
A6 
A9 
AC 
AF 
B2 
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067 
070 
073 
076 
079 
082 
085 
088 
091 
094 
097 
100 
103 
106 
109 
112 
115 
118 
121 
124 
127 
130 
133 
136 
139 
142 
145 
148 
151 
154 
157 
160 
163 
166 
169 
172 
175 
178 


delete 


ry 


« 


not used 


‘ 


$5 
s 
not used 


no-break space 


068 
071 
074 
077 
080 
083 
086 
089 
092 
095 
098 
101 
104 
107 
110 
113 
116 
119 
122 
125 
128 
131 
134 
137 
140 
143 
146 
149 
152 
155 
158 
161 
164 
167 
170 
173 
176 
179 


See ae Sl Se 


om 


fo) 


Z 


} 


not used 


not used 


3) 


> 


not used 


069 
072 
075 
078 
081 
084 
087 
090 
093 
096 
099 
102 
105 
108 
111 
114 
117 
120 
123 
126 
129 
132 
135 
138 
141 
144 
147 
150 
153 
156 
159 
162 
165 
168 
171 
174 
177 
180 


~“~N BZHH ZA 


{ 


not used 


” 


Z 
S 
not used 


not used 


“cc 





BS 
B8 
BB 
BE 
Cl 
C4 
C7 
CA 
CD 
DO 
D3 
D6 
D9 
DC 
DF 
E2 
ES 
E8 
EB 
EE 
Fl 
F4 
F7 
FA 
FD 


Entering characters at the keyboard 


181 
184 
187 
190 
193 
196 
199 
202 
205 
208 
211 
214 
217 
220 
223 
226 
229 
232 
235 
238 
241 
244 
247 
250 
253 


— 


PoCcoo w 


B6 
B9 
BC 
BF 
C2 
C5 
C8 
CB 
CE 
D1 
D4 
D7 
DA 
DD 
E0 
E3 
E6 
E9 
EC 
EF 
F2 
F5 
F8 
FB 
FE 


182 
185 
188 
191 
194 
197 
200 
203 
206 
209 
212 
215 
218 
221 
224 
227 
230 
233 
236 
239 
242 
245 
248 
251 
254 


B7 
BA 
BD 
CO 
C3 
C6 
C9 
CC 
CF 
D2 
DS 
D8 
DB 
DE 
El 
E4 
E7 
EA 
ED 
FO 
F3 
F6 
F9 
FC 
FF 


183 


186 ° 
189 % 
192 A 
195 A 
198 A 
201. —O«£ 
204s 
207 — ss 
210 O 
213 (e) 
216 @ 
219 U 
222 «~#P 
225 A 
228i 
231 6 ¢ 
234 «= é 
237i 
240 «6 
243.6 
246 «6 
249 a 
282: 
255 


Any of the characters in the character set can be entered directly from the keyboard: 


. Look up the decimal code of the character you want from the preceding table. 


2. Hold down the Ctrl key and type the three-digit code, then release the control key. 


Make sure that you include any preceding zeros to make the code three digits long - for example use 
Ctrl+096 to enter a single left quote, ‘. 


Modification of character codes 
The keycode value is modified when pressing Ctrl at the same time as another key. 


For alphabetic keys the Ctrl modified value is the ordinal position in the alphabet ignoring upper and 
lower case, i.e. 1 for Ctrl+A or Shift+Ctrl+A, 2 for Ctrl+B or Shift+Ctrl+B, etc. This value can be 
found by ANDing the ASCII value of the alphabetic character with (NOT $60). So the keycode of 
upper and lower case letters is the same when pressed together with Ctrl, with only the value of the 


modifier differing. For example, pressing Ctrl+J returns 10 which is (33 AND 


(NOT $60)). 
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Other special keys 
The keycodes (returned by GETEVENT32, etc) for these special keys are as follows: 


key hex decimal key hex decimal 
Home 1002 4098 End 1003 4099 
PgUp 1004 4100 PgDn 1005 4101 

3 1007 4103 8 1008 4104 

5 1009 4105 6 100A 4106 
Menu 1036 4150 


GET and KEY, however, return the same values as on the Series 3c (see below). 


CHARACTER CODES ON THE SERIES 3C AND SIENA 


To find out a character’s character code either look up the character in the table given in the back of 
your User Guide, or press the Calc button and type the % sign followed by the character for example %P 
returns 80. Characters with codes from 0 to 127 are the same as in the ASCII character set. Codes 128 
to 255 are compatible with the IBM code page 850. 


Codes from 256 upwards are for other Series 3c keys see the list below. 


Character codes of special keys 


The GET and KEY functions return the character code of the key that was pressed. Some of the keys 
are not in the character set. They return these numbers: 


Esc 27 Tab 9 
Delete 8 Enter 13 
256 | 257 
= 258 = 259 
Pg Up 260 Pg Dn 261 
Home 262 End 263 
Menu 290 Help 291 


(*) 292 


The Psion key adds 512 to the value of the key pressed. For example, Psion-a is 609 (512+97), and 
Psion-Help (Dial) is 803 (512+291). 


SPECIAL CHARACTER CODES WITH PRINT 
These values can be used with PRINT and CHR$(): 


7 beep 

8 backspace 

9 tab 

10 line feed 

12 form feed (clear screen) 

13 carriage return (cursor to left of window) 


For example, PRINT CHRS$ (8) moves the cursor backwards, one character to the left. 
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KEYBOARD MODIFIERS 


Keyboard modifier values are the same for all machines, except that the Psion key (modifier value 8) 
does not exist on the Series 5. 





GETEVENT a%() returns the modifier for a keypress in (a&(2) AND Sff). 




















I ceTeventT32 evs () returns modifiers to ev& (4) for keypresses and in ev& (5) for pointer 











(pen) events. 


The values which can be returned are as follows: 


modifier value constant name (Series 5 only) 
Shift 2 KKmodShift% 

Control 4 KKmodControl% 

Caps 16 KKmodCaps% 


I For the Series 5 there is additionally a Fn key: 


Fn 32 KKmodFn% 


I For the Series 3c there is additionally a Psion key: 


Psion 8 - 


Appendices 357 


E ListinG oF CONST.OPH FOR SERIES 5 


358 


DH FH FH BD 


EM (C 








CONST 


CONST 





CONST 


CONST 


CONST 


CONST 


CONST 





CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 


CONST 








CONST 


EM CONST.OPH version 1.10 
EM Constants for OPL 


EM Last edited on 19 May 1997 


) Copyright Psion PLC 1997 


ta type 


KMaxFloa 


KMinFloa 


KMinFloa 














KKeyDel% 


KGetMenu 


KKeyRigh 


KKeyPage 


KKeyPage 











KKeyPage 


KMinInt%=$8000 





REM General constants 
KTrues=-1 


KFalse%=0 


ranges 


KMaxStringhLen%=255 


t=1.79769313486231571] 
t=2.22507385850720151 


REM Minimum with 


E+308 





E-308 


full precision in mantissa 








tDenorm=5e-324 


REM Denormalised 














KMaxInt%=32767 





KMaxLong&=2147483647 


REM Special keys 
KKeyESc%s=27 


KKeySpace%S=32 


KKeyTab%s=9 
KKeyEnter%s=13 
%=4150 
KKeyUpArrow%s=4105 
KKeyDownArrow%s=4106 


KKeyLeftArrows=4103 


tArrow%s=4104 


KKeyPageUps=4100 


Down%S=4101 


Left%=4098 





Right%=4099 


(just one bit of precision left) 


REM -32768 (translator needs hex for maximum ints) 





KMinLong&=&80000000 REM -2147483648 (hex for translator) 
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REM Month numbers 





CONST KJanuary%=1 
CONST KFebruary%=2 
CONST KMarch%= 
CONST KApril%= 
CONST KMay%=5 


CONST KJune%=6 





CONST KJuly%=7 
CONST KAugust%=8 
CONST KSeptember%=9 
CONST KOctober%=10 


CONST KNovember%=11 





CONST KDecember%=12 





REM Graphics 

CONST KDefaultWin%s=1 
CONST KgModeSet%=0 
CONST KgModeClear%=1 
CONST KgModeInvert%=2 
CONST KtModeSet%=0 


CONST KtModeClear%=1 





CONST KtModelInvert%=2 








CONST KtModeReplace%=3 


CONST KgStyleNormal%=0 
CONST KgStyleBold%= 
CONST KgStyleUnder%S=2 
CONST KgStyleInverse%S=4 


CONST KgStyleDoubleHeight%=8 








CONST KgStyleMonoFont%S=16 








CONST KgStyleItalic%S=32 


REM For 32-bit status words IOWAIT and IOWAITSTAT32 








REM Use KErrFilePendings (-46) for 16-bit status words 


CONST KStatusPending32&=&80000001 











REM Error codes 














CONST KErrGenFail%=-1 
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CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 


CONST 








CONST 





ry 


ry 


ry 





rInvalidArgs%=-2 
rOss=-3 
rNotSupported%s=-4 
rUnderflow%s=-5 
rOverflow%s=-6 
rOutOfRange%s=-7 
rDivideByZero%s=-8 
rInUse%=-9 
cNoMemory%s=-10 
rNoSegments%=-11 
rNoSemaphore%S=-12 
cNoProcess%=-13 
rAlreadyOpen%s=-14 
rNotOpen%S=-15 
rImage%s=-16 


fo) 


rNoReceiver%S=-17 





rNoDevices%=-18 








fo) 


rTooWide%=-22 


rBatLowSound%=-24 





rBatLowFlash%=-25 








rExists%=-32 








rNotExists%=-33 








rWrite%t=-34 








rRead%=-35 
rEof%=-36 
rFull%S=-37 





rName%S=-38 
rAccess%=-39 


rLocked%=-40 














rDevNotExist%=-41 





rDir%s=-42 


rRecord%=-43 





rReadOnly%s=-44 





rInvalidI0O%=-45 


rNoFileSystem%=-19 
rFailedToStart%=-20 


rFontNotLoaded%=-21 


rTooManylItems%=-23 
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oN 
nal 


aN 
Gl 


ty 


rFilePending%=—46 


ErrVolume%S=-47 


ErrlOCancelled%=-48 





specific errors 


ErrSyntax%=-77 
KOplStructure%s=-85 
ErriIllegal%=-96 
ErrNumArg%=-97 
ErrUndef%=-98 
ErrNoProc%=-99 
ErrNoFld%=-100 
ErrOpen%S=-101 
ErrClosed%=-102 
ErrRecSize%=-103 


ErrModLoad%=-104 








ErrMaxLoad%=-105 





ErrNoMod%=-106 


ErrNewVer%=-107 








ErrModNotLoaded%S=-108 
ErrBadFileType%s=-109 


ErrTypeViol%S=-110 


ry 


rSubs%$=-111 


ry 


cStrTooLong%s=-112 


ErrDevOpen%=-113 





icrEsc%S=-114 











ErrMaxDraw%=-117 





fo) 


y 


ErrDrawNotOpen%S=-118 


es 


ErrInvalidWindow%=-119 
ErrScreenDenied%=-120 
ErrOpxNotFound%=-121 
ErrOpxVersion%=-122 
ErrOpxProcNotFound%=-123 
ErrStopInCallback%=-124 


ErriIncompUpdateMode%=-125 





ErrinTransaction%=-126 








REM For ALERT 

















CONST KAlertEsc%=1 
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CONST KAlertEnter%=2 





CONST KAlertSpace%=3 





REM For BUSY and GIPRINT 
CONST KBusyTopLeft%=0 
CONST KBusyBottomLeft%=1 
CONST KBusyTopRight%=2 


CONST KBusyBottomRight%= 














CONST KBusyMaxText%=80 





REM For CMDS 





CONST KCmdAppName%=1 REM Full path name used to start program 
UsedFile%s=2 


Letter%=3 








LetterCreateS="C" 


d 
d 

REM For CMDS (3) 
d 
dLetterOpen$="0" 
d 














LetterRun$="R" 














REM For CURSOR 
CONST KCursorTypeNotFlashing%=2 


CONST KCursorTypeGrey%s=4 





REM For DATIMS - offsets 
CONST KDatimOffDayName%S=1 
CONST KDatimOffDay%=5 
CONST KDatimoOffMonths=8 
CONST KDatimOffYear%=12 
7 


CONST KDatimOffHourS=1 








CONST KDatimOffMinute%t=20 














CONST KDatimOffSecond%=23 





REM For dBUTTON 
CONST KDButtonNoLabel%=$100 
CONST KDButtonPlainkey%=$200 
CONST KDButtonDel%=8 


CONST KDButtonTab%=9 





























CONST KDButtonEnter%=13 


Appendices 363 


CONST KDButtonEsc%=27 





CONST KDButtonSpace%=32 











CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 


CONST 


K 


K 


K 


K 


K 





REM For dEDITMULTI and printing 


ParagraphDelimiter%=S06 
LineBreak%=S07 


PageBreak%=S08 


KTabCharacter%=S09 
KNonBreakingTab%=S0a 


KNonBreakingHyphen%=S0b 


PotentialHyphen%=S0c 


KNonBreakingSpace%=S10 








PictureCharacter%=S0e 


KVisibleSpaceCharacter%=S0f 





REM For DEFAULTWIN 








CONST KDefWin4ColourMode%=1 


CONST KDefWinl6ColourMode%=2 





REM For dFIL 





CONST 


CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 


CONST 





CONST 
CONST 
CONST 


CONST 








CONST 
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K 


RI 


x 


aN 


aN 


x 





aN 


REM Opl-related Uids for dFILE 


K 


K 





E 


DFileNameLen%=255 





EM flags 





DFileFditBox%=S0001 
DFileAllowFolders%=$0002 
DFileFoldersOnly%=$0004 


DFileEditorDisallowExisting%=$0008 














DFileEditorQueryExisting%=$0010 


DFileAllowNullStrings%=$0020 





DFileAllowWildCards%=$0080 


DFileSelectorWithRom%=$0100 





DFileSelectorWithSystem%=$0200 





UidOplinterpreteré&=268435575 
UidOplApp &=268435572 
UidOp1Doc&=268435573 
UidOPO&=268435571 








UidOp1lFile&=268435594 


CONST KUidOpxD11&=268435549 


REM For DIALOG 





CONST KDlgCancel%=0 


REM For dINIT (flags for dialogs) 





CONST KDlgButRight3=1 
CONST KD1gNoTitle$=2 


CONST KDlgFillScreen%= 





CONST KDlgNoDrag%=8 











CONST KDlgDensePack%S=16 


REM For DOW 





CONST KMonday%=1 
CONST KTuesday%=2 
CONST KWednesday%=3 
CONST KThursday%s=4 
CONST KFriday%s=5 


CONST KSaturday%s=6 





CONST KSunday%=7 


REM For dPOSITION 





CONST KDPositionLeft%=-1 
CONST KDPositionCentre%=0 


CONST KDPositionRight%=1 





REM For dTEXT 








CONST KDTextLeft%=0 
CONST KDTextRight%=1 
CONST KDTextCentre%s=2 
CONST KDTextBold%=$100 


CONST KDTextLineBelow%=$200 








CONST KDTextAllowSelection%=$400 











CONST KDTextSeparator%S=$800 


REM For dTIM 








Gl 


CONST KDTimeAbsNoSecs%=0 








CONST KDTimeAbsWithSecs%=1 








EM Ignored in Eikon 
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CONST KDTimeDurationNoSecs%= 


CONST KDTimeDurationWithSecs%=3 





REM Flags for dTIME (for ORing combinations) 





CONST KDTimeWithSeconds%=1 





CONST KDTimeDuration%=2 





CONST KDTimeNoHours%= 














CONST KDTime24Hour%s=8 





REM For dXINPUT 





CONST KDXInputMaxLen%=16 








REM For FINDFIELD 
CONST KFindCaseDependent%=16 
CONST KFindBackwards%=0 


CONST KFindForwards%=1 





CONST KFindBackwardsFromEnd%=2 








CONST KFindForwardsFromStart%=3 


REM For FLAGS 





CONST KFlagsAppFileBased%=1 








CONST KFlagsAppIsHidden%=2 





REM For gBORDER and gXBORDER 








CONST KBordSglShadow%=1 
CONST KBordSglGap%=2 

CONST KBordDb1lShadow%= 

CONST KBordDb1lGap%=4 

CONST KBordGapAl1lRound%=$100 


CONST KBordRoundCorners%=$200 











CONST KBordLosePixel%=S400 


REM For gBUTTON 





CONST KButtS3%=0 
CONST KButtS3Raised%=0 
CONST KButtS3Pressed%= 


CONST KButtS3a%=1 























CONST KButtS3aRaised%=0 
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CONST KBu 
CONST KBu 
CONST KBu 
CONST KBu 
CONST KBu 


CONST KBu 


CONST KBu 
CONST KBu 
CONST KBu 
CONST KBu 
CONST KBu 
CONST KBu 
CONST KBu 
CONST KBu 
CONST KBu 


CONST KBu 











CONST KBu 





CONST KgCloc 
CONST KgCloc 
CONST KgCloc 


CONST KgCloc 





CONST KgCloc 





CONST KgC 
CONST KgC 
CONST KgC 
CONST KgC 


CONST KgC 





CONST KgC 


REM For gCREATE 


ttSSS= 














REM For gCLOCK 


























REM For Gl 





CONST KG 


ETCMDS 


2 





ttS3aSemiPressed%=1 


ttS3aSunken%=2 


ttSsRaised%=0 


ttSsSemiPressed%S=1 





ttS5Sunken%S=2 
ttLayoutTextRightPictureLeft%=0 
ttLayoutTextBottomPictureTop%=1 
ttLayoutTextTopPictureBottom%s=2 
ttLayoutTextLeftPictureRight %= 
ttTextRight%=0 


ttTextBottom%s=1 


ttTextLefts= 
ttExcessShare%=$00 
ttExcessToText%=S10 


ttExcessToPicture%=$20 


kS5System%s=6 
kS5SAnalog%=7 
kS5Digital%S=8 
kSS5LargeAnalog%=9 


kS5Formatted%=11 


reateInvisibles=0 
reateVisibles=1 
reate2ColourMode%=$0000 
reate4ColourMode%s=$0001 
reatel6ColourMode%=S0002 


reateHasShadow%=S0010 





tCmdLetterCreate$="C" 





CONST KG 








CONST KGe 








tCmdLetterOpenS="0" 


tCmdLetterExit$="X" 
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CONST KGetCmdLetterUnknown$="U" 


REM For gLOADBIT 





CONST KgLoadBitReadOnly%=0 





CONST KgLoadBitWriteable%=1 





REM For gRANK 





CONST KgRankForeground%=1 


CONST KgRankBackGround%=32767 








REM For gPOLY - array subscripts 
CONST KgPolyAStartx%=1 





CONST KgPolyAStartY%S= 
CONST KgPolyANumPairs%=3 


CONST KgPolyANumDx1%= 














CONST KgPolyANumDy1%= 


REM For gPRINTB 





CONST KgPrintBRightAligned%=1 
CONST KgPrintBLeftAligned%= 
CONST KgPrintBCentredAligned%s= 


REM The defaults 





CONST KgPrintBDefAligned%=KgPrintBLeftAligned% 
CONST KgPrintBDefTop%=0 


CONST KgPrintBDefBottom%= 











0 
CONST KgPrintBDefMargin%=0 











REM For gXBORDER 
CONST KgXBorderS3Type%s=0 
CONST KgXBorderS3aType%s=1 


CONST KgXBorderS5Type%s=2 


REM For gXPRINT 





CONST KgXPrintNormal%=0 
CONST KgXPrintInverse%=1 
CONST KgXPrintInverseRound%s= 


CONST KgXPrintThinInverse%= 




















CONST KgXPrintThinInverseRound%= 
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CONST KgXPrintUnderlined%= 


CONST KgXPrintThinUnderlined%t=6 


REM For KMOD 





CONST KKmodShift%=2 
CONST KKmodControl%= 
CONST KKmodPsion%=8 


CONST KKmodCaps%=16 








CONST KKmodFn%=32 








REM For mCARD and mCASC 

CONST KMenuDimmed%=$1000 

CONST KMenuSymbol0n%=$2000 

CONST KMenuSymbolIndeterminate%=$ 4000 
CONST KMenuCheckBox%=$0800 

CONST KMenuOptionStart%=$0900 


CONST KMenuOptionMiddle%=S0A00 




















CONST KMenuOptionEnd%=$0B00 


REM For mPOPUP position type 





REM Specifies which corner of the popup is given by the coordinates 
CONST KMPopupPosTopLeft%=0 
CONST KMPopupPosTopRight%=1 


CONST KMPopupPosBottomLeft%=2 











CONST KMPopupPosBottomRight%= 














REM For PARSES - array subscripts 
CONST KParseAOffFSys%=1 
CONST KParseAOffDevs=2 
CONST KParseAOffPaths= 


CONST KParseAOffFilename%=4 





CONST KParseAOffExt%= 
CONST KParseAOffWild%t=6 


REM Wild-card flags 





CONST KParseWildNone%=0 


CONST KParseWildFilename%=1 





CONST KParseWildExt%=2 

















CONST KParseWildBoth%= 
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REM For SCR 


CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 


CONST 











G 














REM For Sl 


CONST 
CONST 
CONST 


CONST 


REM For Get! 





CONST KI 


CONST KI 














CONST KI 


CONST 





REM Pointer 


CONST 
CONST 
CONST 
CONST 
CONST 
CONST 


CONST 








CONST 
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IENINFO - array subscripts 
KSInfoALeft%=1 

KSInfoATop%s=2 

KSInfoAScrwW%s= 

KSInfoAScrH%s=4 
KSInfoAReserved1%= 
KSInfoAFont%s=6 


KSInfoAPixw%s=7 





KSInfoAPixH%=8 


KSInfoAReserved2%$=9 





KS InfoAReserved3%=10 


ETFLAGS 


KRestrictTo64kK&é&=&0001 


KAu 





toCompact &=&0002 





KTwoDigitExponent &=&0004 


KSendSwitchOnMessage&=&010000 


K 





KE 


KE 




















Event32 
REM Array indexes 
EVAType%s= 


EVATime%= 


REM Event array keypress subscripts 
EVAKMod%s=4 


EVAKRep%s=5 


event array subscripts 
cOplWindowld%= 
rWindowld%= 

rTypes= 

rModifiers%=5 
rPositionX%=6 
rPositionY%= 


rScreenPosx%=8 





rScreenPosY%=9 











REM Event types 





CONST KEvNotKeyMaské& 
CONST KEvFocusGained 


CONST 


aN 


EvFocusLost&= 


CONST 


aN 


EvSwitchoOné=& 


CONST 


aN 


EvCommand&=&4 
CONST KEvDateChanged 
CONST KEvKeyDown&=&4 
CONST KEvKeyUp&=&407 


CONST KEvPtr&=&408 





CONST KEvPtrEnteré&=& 




















CONST KEvPtrExit&=&4 








REM Pointer event ty 
CONST KEvPtrPenDowné& 
CONST KEvPtrPenUpé=1 
CONST KEvPtrButton1D 
CONST KEvPtrButtonlu 
CONST KEvPtrButton2D 
CONST KEvPtrButton2uU 


CONST KEvPtrButton3D 

















CONST KEvPtrButton3U 
CONST KEvPtrDrag&=6 


CONST KEvPtrMove&=7 





CONST KEvPtrButtonRe 











Q 
(e) 
za 
n 
=| 
N 
GI 
< 
U 
ct 


rSwitchOn 


N 


CONST KKeyMenuS=4150 








CONST 


aN 


KeySidebarMen 


=&400 
&=&401 
&402 
403 

04 
&=&405 
06 


409 


OA 


pes 


=0 


own &=KEvPtrPenDown& 








p&=KEvPtrPenUp& 


peat &=8 


&=9 


us=10000 





REM For PointerFilte 





1g 





CONST KPointerFilter 











CONST KPointerFilter 


CONST KPointerFilter 


REM Code page 1252 e 





Move%S=S2 





Drag%=S4 


llipsis 


EnterExit%=$1 


("windows latin 





CONST KScreenEllipsi 


$%=133 














CONST KScreenLineF 


d%=10 


1") 
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REM For gCLOCK 

CONST KClockLocaleConformant%=6 

CONST KClockSystemSetting%s=KClockLocaleConformant% 
CONST KClockAnalog%=7 

CONST KClockDigital%=8 

CONST KClockLargeAnalog%=9 

REM GClock 10 no longer supported (use slightly changed gCLOCK 11) 
CONST KClockFormattedDigital%=11 

REM For gFONT (these may change before release) 
CONST KFontArialBold8é= 268435951 
CONST KFontArialBold1l1é= 268435952 
CONST KFontArialBold1l3&= 268435953 
CONST KFontArialNormal8 &= 268435954 
CONST KFontArialNormalll1é&= 268435955 
CONST KFontArialNormal13&= 268435956 
CONST KFontArialNormal15&= 268435957 
CONST KFontArialNormall18 &= 268435958 
CONST KFontArialNormal22&= 268435959 
CONST KFontArialNormal27&é= 268435960 
CONST KFontArialNormal32&= 268435961 
CONST KFontTimesBold8 &= 268435962 
CONST KFontTimesBold11é= 268435963 
CONST KFontTimesBold13é= 268435964 
CONST KFontTimesNormal8 &= 268435965 
CONST KFontTimesNormalll1&= 268435966 
CONST KFontTimesNormal13&= 268435967 
CONST KFontTimesNormal15&= 268435968 
CONST KFontTimesNormall18 &= 268435969 
CONST KFontTimesNormal22&= 268435970 
CONST KFontTimesNormal27&= 268435971 
CONST KFontTimesNormal32&= 268435972 
CONST KFontCourierBold8 &= 268436062 
CONST KFontCourierBold1l1&= 268436063 
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CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 
CONST 


CONST 


CONST 
CONST 


CONST 


CONST 
CONST 
CONST 


CONST 


CONST 


CONST 


CONST 


CONST 


CONST 


CONST 








CONST 


REM For IOOPEN 





CONST 
CONST 
CONST 


CONST 








CONST 









































KFontCourierBold13&= 
KFontCourierNormal8&= 
KFontCourierNormalllé= 
KFontCourierNormal13é= 
KFontCourierNormal15é= 
KFontCourierNormal18é= 
KFontCourierNormal22&é= 
KFontCourierNormal27&é= 
KFontCourierNormal 32 &é= 
KFontCalcl3né&= 26843549 
KFontCalcl8né&= 26843549 
KFontCalc24né&= 26843549 
KFontMon1 8né= 26843549 
KFontMon18bé= 26843549 
KFontMon9né= 26843549 
KFontMon9b&= 26843550 
KFontTinylé= 26843550 
KFontTiny2é= 26843550 
KFontTiny3é= 26843550 
KFontTiny4é= 26843550 
KFontHiksym15&= 26843566 
KFontSquashed&= 26843570 
KFontDigital35&= 26843575 





REM Mode category 1 


KToOpenModeOpen%=$0000 





KT oOpenModeCreate%=S0001 





KIT oOpenModeReplace%=$0002 
KT oOpenModeAppends=$0003 














KT oOpenModeUnique%=S0004 





2684 


36064 


268436065 


2684 
2684 
2684 


36066 
36067 
36068 


268436069 


2684 
2684 





2684 


3 
4 
5 


a] 
8 
9 
0 


1 
2 
3 
4 


1 


1 
2 


36070 
36071 
36072 
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REM 





Mode category 2 


CONST KIoOpenFormatBinary%=$0000 


CONST KIoOpenFormatText%=S0020 


REM 








Mode category 3 


CONST KIoOpenAccessUpdate%=$0100 


CONST KIoOpenAccessRandom%=$0200 


CONST KIoOpenAccessShare%=S0400 


REM 





CONST K 
CONST K 
CONST K 
CONST K 
CONST 
CONST 
CONST K 
CONST K 
CONST K 
CONST K 
CONST K 
CONST K 
CONST K 
CONST K 
CONST K 
CONST K 
CONST K 
CONST K 
CONST K 
CONST K 


CONST K 








Language code for CAPTION 


aN 


aN 














End 
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aangEnglish%=1 





LangFrench%=2 
LangGerman%=3 
LangSpanish%= 
LangItalian%s= 
LangSwedish%=6 
LangDanish%= 
LangNorwegian%=8 
LangFinnish%=9 
LangAmerican%=10 
LangSwissFrench%=11 
LangSwissGerman%S=12 
LangPortuguese%s=13 
LangTurkish%=14 
LangIcelandic%=15 
LangRussian%=16 
LangHungarian%=17 


LangDutch%=18 


aangBelgianFlemish%=19 











LangAustralian%=20 





LangBelgianFrench%=21 


of Const.oph 
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Note on syntax 


The use of square brackets [ ] indicates that something is optional, while a vertical line | indicates a 
choice shold be made between mutually exclusive options. Words in heavy mono-spaced type (e.g. 
SELECT) should be typed in literally . 


SQL keywords are case insensitive. 


SELECT STATEMENT 


select-statement : 


SELECT select-list 
FROM table-name 
[ WHERE search-condition | 
{[ ORDER BY sort-order | 


Use a select-statement to specify what data should be present in the view, and how to present it. 


Selecting columns 


select-list : 
* 


column-name-comma-list 


Specify * to request that all columns for the table be returned in the view, in an undefined order; 
otherwise a comma separated list specifies which columns to return, and the order that the columns 
appear in the view. 


Names 


table-name 


column-name 


The table-name should be a table which exists in the database. Column names should refer to columns 
which exist in the specified table. 


SEARCH CONDITION 


search-condition : 
boolean-term [ OR search-condition | 


boolean-term : 
boolean-factor [ AND boolean-term | 


boolean-factor : 
[ NOT ] boolean-primary 


boolean-primary : 
predicate 
( search-condition ) 


This specifies a condition which a row must meet to be present in the generated view. A trivial search 
condition is just a single predicate, more complex search conditions are constructed by combining 
predicates using the keywords AND, OR and NOT, and using parentheses to override the standard 
precedence of these operators. Without brackets, the order of precedence is NOT, AND then OR. e.g. 


a=l or not b=2 and c=3 
is equivalent to 


(a=l or ((not b=2) and c=3)) 
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Predicates 


predicate : 
comparison-predicate 
like-predicate 
null-predicate 


These are the building blocks of the search condition. Each predicate tests one condition of a column in 
the selected table. 


Comparison predicate 


comparison-predicate : 
column-name_ comparison-operator literal 


comparison-operator : 
<|> | <= | >=] =| <> 


Compare a column value with a supplied literal value. Numeric columns (including bit columns) are 
compared numerically, text columns are compared lexically and date columns are compared 
historically. Binary columns cannot be compared. The literal must be of the same type (numeric, string, 
date) as the column. 


Literals 


literal : 
string-literal 
numeric-literal 
date-literal 


A string-literal is a character string enclosed in single quote characters *. To include a single literal 
quote character ‘ in a string-literal, use two literal quote characters ‘’. 


A numeric-literal is any sequence of characters which can be interpreted as a valid decimal integral or 
floating point number. 


A date-literal is a character string enclosed by the # character, which can be interpreted as a valid date. 


Like predicate 


like-predicate : 
column-name [ NOT ] LIKE pattern-value 


pattern-value : 
string-literal 


Test whether or not a text column matches a pattern string. The wildcard characters used in the 
pattern-value are not standard SQL, instead the EPOC32 wildcard characters are used: ? for matching 
any single character and * for matching zero or more characters. 


Null predicate 


null-predicate : 


column-name IS [| NOT ] NULL 


Test whether or not a column is Null. This predicate can be applied to all column types. 


Specifying a sort order 


sort-order : 
sort-specification-comma-list 


sort-specification : 


column-name [ ASC | DESC ] 
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Without an ORDER BY clause in the select statement the order that rows are presented is undefined. 
The columns specified in the sort-order can be ordered in ascending (the default) or descending order, 
and should appear in the sort-order in decreasing order of precedence. e.g. 


surname, first name 


will order the rows by the column surname, and any rows with identical surnames will then be 
ordered by the column first name. 
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G EPOC32 Error VALUES 
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The error values returned by EPOC32 are listed below. Note that these are different from the error 
values returned by OPL in general. They may, however, be returned in the status word of asynchronous 


OPX functions. 
meaning 

no error 

general error 

no memory 
argument error 
bad handle 
underflow error 
path not found 

in use 

server busy 

not ready 

corrupt 

locked 
dismounted 

disk full 

bad name 

comms frame error 
comms parity error 
could not connect 
disconnected 

bad descriptor 
too big 


bad power 
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value 


meaning 

not found 

cancel 

not supported 

total loss of precision 
overflow error 
already exists 

died 

server terminated 
completion 
unknown error 
access denied 

write error 

end of file 

bad driver 

comms line fail 
comms overrun 
timed out 

could not disconnect 
bad library entry point 
abort 

divide by zero 


directory full 


value 


